Skip to main content

任务工作模式说明

本文说明「查询任务工作模式」接口(POST /openapi/v3/tasks/fusion/work-modes/list)返回的 workMode 完整配置结构、各字段含义,以及目前已知的全部工作模式枚举。不同产品线支持的工作模式组合不同。

支持版本​

A6+

使用示例(workMode 对象)​

创建组合任务或排班时,workMode 对象使用示例如下:

{
"workMode": {
"id": "f476ea80b55042efbd69d31f52d039ff",
"mode": "wash",
"subType": "wash",
"type": 0,
"strength": "middle"
}
}

workMode 完整配置结构​

{
"id": "f476ea80b55042efbd69d31f52d039ff",
"mode": "wash",
"subType": "wash",
"type": 0,
"configType": "strength",
"hasStrength": true,
"recommended": true,
"subTaskEnabled": true,
"defaultStrength": "middle",
"strengthOptions": ["low", "middle", "high"]
}

字段说明​

字段类型示例值说明备注
idstringf476ea80b55042efbd69d31f52d039ff工作模式 ID,用于唯一区分同一产品线下的各个模式创建组合任务/排班时引用此 ID
modestringwash工作模式机器码(模式展示标识),仅包含小写字母、数字和下划线全部取值见工作模式枚举
subTypestringwash模式内部标识(英文枚举值),用于前后端交互当前实现中与 mode 一致
typeint0工作任务类型0=CLEAN(清洁任务);5=WORK(作业任务:巡检/强力洗地)。清洁模式为 0,巡检、强力洗地为 5
recommendedbooltrue是否推荐该模式每个产品线通常将一个模式标记为推荐
configTypestringstrength配置方式strength=有清洁档位;fixed=固定配置(无档位);custom=自定义配置(预留,当前无实例)
hasStrengthbooltrue是否支持清洁档位调节configType=strength 时为 true,fixed 时为 false
strengthOptionsarray<string>["low","middle","high"]可选档位列表巡检、强力洗地等固定配置模式为空数组 [];部分模式仅支持单一档位(如 ["middle"])。数组顺序不代表档位高低
defaultStrengthstringmiddle默认档位巡检、强力洗地为空字符串 ""
subTaskEnabledbooltrue是否支持作为组合任务中的子任务清洁模式通常为 true;巡检、强力洗地为 false(只能独立执行)

字段之间的关联​

  • type=0(清洁任务):configType=strength、hasStrength=true、defaultStrength 为 low/middle/high 之一、subTaskEnabled=true。
  • type=5(作业任务:巡检、强力洗地):configType=fixed、hasStrength=false、strengthOptions=[]、defaultStrength=""、subTaskEnabled=false。

工作模式枚举​

以下枚举汇总自任务服务当前配置,覆盖全部已知取值。mode 与 subType 当前取值一致。

清洁任务(type=0)​

mode / subType名称说明
sweep扫地干扫清洁,适用于硬质地面
sweep_wash扫洗扫地与洗地复合模式,一次通过完成扫+洗
wash洗地湿式洗地清洁
sweep_vacuum扫吸扫地与吸尘复合模式,一次通过完成扫+吸
vacuuming吸尘纯吸尘清洁,适用于地毯等场景
dust_push尘推使用尘推布进行干式推尘养护
roller_dust_push滚刷尘推使用滚刷进行尘推清洁
silent_dust_push静音推尘低噪音尘推,适用于对噪音敏感的场景
aromatherapy香薰移动过程中释放香氛,无水清洁
disinfectant消杀喷洒消毒液进行消杀作业
sweep_vacuum_clean扫吸清洁扫地与吸尘复合的深度清洁模式
carpet_cleaning地毯清洁针对地毯的吸尘清洁模式
hot_wash热水洗地使用热水进行洗地,去油污能力更强

作业任务(type=5)​

mode / subType名称说明
inspect巡检按路线巡检,若发现可清洁的污渍则自主进行清洁
strong_wash强力洗地强力洗地作业,用于重污渍场景
info

工作模式按机器人产品线配置,上表是全量枚举,单台机器人实际支持的模式以其「查询任务工作模式」接口返回为准。例如扫地车产品线通常只返回 sweep、inspect,洗地车产品线通常返回 wash、dust_push、inspect。

档位枚举​

strength名称说明
low轻柔轻柔档位清洁,速度快、噪音低,适用于轻度脏污
middle标准标准档位清洁(多数模式的默认值)
high强劲强劲档位清洁,适用于重度脏污

仅 configType=strength 的模式支持档位调节;strengthOptions 为该模式实际可选的档位子集,defaultStrength 为不传 strength 时使用的默认档位。

configType 枚举​

configType含义特征
strength有清洁档位hasStrength=true,需提供/可选 strength,strengthOptions 非空
fixed固定配置hasStrength=false,无档位,strengthOptions=[]、defaultStrength="";巡检、强力洗地属于此类
custom自定义配置预留枚举,当前线上数据暂无实例

使用示例​

创建组合任务或排班时,workMode 引用「查询任务工作模式」返回的对象:

{
"workMode": {
"id": "f476ea80b55042efbd69d31f52d039ff",
"mode": "wash",
"subType": "wash",
"type": 0,
"strength": "middle"
}
}
  • id + mode(+ subType)共同定位一个工作模式;id 为空时可仅通过 mode 匹配。
  • strength 不传时使用该模式的 defaultStrength;传值必须是 strengthOptions 中的元素。
  • 固定配置模式(configType=fixed,如 inspect、strong_wash)不传 strength。

典型产品线配置示例​

以下为任务服务中的真实配置示例,展示不同产品线的模式组合差异。

洗地车产品线(支持洗地、尘推、巡检):

[
{"id": "7f94c2fe1e744ea7a06a411329dc763f", "mode": "sweep", "type": 0, "subType": "sweep", "configType": "strength", "hasStrength": true, "recommended": true, "subTaskEnabled": true, "defaultStrength": "middle", "strengthOptions": ["low", "middle", "high"]},
{"id": "d1b03d7c0c1c4773b9dae3d4d027037e", "mode": "sweep_wash", "type": 0, "subType": "sweep_wash", "configType": "strength", "hasStrength": true, "recommended": false, "subTaskEnabled": true, "defaultStrength": "middle", "strengthOptions": ["low", "middle", "high"]},
{"id": "0fa484cfec2a4d618c7bd17583315ece", "mode": "wash", "type": 0, "subType": "wash", "configType": "strength", "hasStrength": true, "recommended": false, "subTaskEnabled": true, "defaultStrength": "middle", "strengthOptions": ["low", "middle", "high"]},
{"id": "", "mode": "dust_push", "type": 0, "subType": "dust_push", "configType": "strength", "hasStrength": true, "recommended": false, "subTaskEnabled": true, "defaultStrength": "middle", "strengthOptions": ["low", "middle", "high"]},
{"id": "3f7a8b2c5d9e4f1a8c6b9e2d7f4a8b3c", "mode": "inspect", "type": 5, "subType": "inspect", "configType": "fixed", "hasStrength": false, "recommended": false, "subTaskEnabled": false, "defaultStrength": "", "strengthOptions": []}
]

含强力洗地的产品线(type=5 包含 strong_wash):

[
{"id": "1dee3b4db66942e5b515acda4c50467a", "mode": "wash", "type": 0, "subType": "wash", "configType": "strength", "hasStrength": true, "recommended": true, "subTaskEnabled": true, "defaultStrength": "middle", "strengthOptions": ["high", "low", "middle"]},
{"id": "e9b96b1fb8944bf0bbc442d3f09a315b", "mode": "dust_push", "type": 0, "subType": "dust_push", "configType": "strength", "hasStrength": true, "recommended": false, "subTaskEnabled": true, "defaultStrength": "middle", "strengthOptions": ["high", "low", "middle"]},
{"id": "3f7a8b2c5d9e4f1a8c6b9e2d7f4a8b3c", "mode": "inspect", "type": 5, "subType": "inspect", "configType": "fixed", "hasStrength": false, "recommended": false, "subTaskEnabled": false, "defaultStrength": "", "strengthOptions": []},
{"id": "6e4d8a9f2b7c3e5a1d9f6b8c4e7a2d5f", "mode": "strong_wash", "type": 5, "subType": "strong_wash", "configType": "fixed", "hasStrength": false, "recommended": false, "subTaskEnabled": false, "defaultStrength": "", "strengthOptions": []}
]

商用清洁机器人产品线(香薰/消杀/地毯清洁等无水模式):

[
{"id": "b6680d6bec6f4c6eac0cdbcd1e59d53c", "mode": "disinfectant", "type": 0, "subType": "disinfectant", "configType": "strength", "hasStrength": true, "recommended": false, "subTaskEnabled": true, "defaultStrength": "middle", "strengthOptions": ["low", "middle", "high"]},
{"id": "d42df81e0da148f0b40a37e60807128b", "mode": "aromatherapy", "type": 0, "subType": "aromatherapy", "configType": "strength", "hasStrength": true, "recommended": false, "subTaskEnabled": true, "defaultStrength": "middle", "strengthOptions": ["low", "middle", "high"]},
{"id": "...", "mode": "carpet_cleaning", "type": 0, "subType": "carpet_cleaning", "configType": "strength", "hasStrength": true, "recommended": false, "subTaskEnabled": true, "defaultStrength": "middle", "strengthOptions": ["low", "middle", "high"]}
]

仅支持单一档位的产品线(strengthOptions 只有 middle):

[
{"id": "3bebb490abc04d39ab84ff8044055c6b", "mode": "wash", "type": 0, "subType": "wash", "configType": "strength", "hasStrength": true, "recommended": true, "subTaskEnabled": true, "defaultStrength": "middle", "strengthOptions": ["low", "middle", "high"]},
{"id": "74bf116ab2554e128640a823b559358d", "mode": "dust_push", "type": 0, "subType": "dust_push", "configType": "strength", "hasStrength": true, "recommended": false, "subTaskEnabled": true, "defaultStrength": "middle", "strengthOptions": ["middle"]},
{"id": "3f7a8b2c5d9e4f1a8c6b9e2d7f4a8b3c", "mode": "inspect", "type": 5, "subType": "inspect", "configType": "fixed", "hasStrength": false, "recommended": false, "subTaskEnabled": false, "defaultStrength": "", "strengthOptions": []}
]